/*
 * @Author: 0x9DEFA478
 * @Date: 2021-08-17 18:20:47
 * @LastEditTime: 2021-08-18 00:54:50
 * @LastEditors: 0x9DEFA478
 * @Description: 
 * QQ:2652450237
 * ============================================================================================================================================
 * 
 * 
 * 
 *                                                                                               ************      ****************************
 *                                                                                             ************      ****************************  
 *                                                                                           ************      ****************************    
 *                                                                                         ************      ****************************      
 *                                                                                       ************      ************                        
 *                                                                                     ************      ************                          
 *                                                                                   ************      ************                            
 *                                                                                 ************      ************                              
 *                                                                               ************      ************                                
 *                                                                             ************      ************                                  
 *                                                                           ************      ************                                    
 *                                                                         ************      ************                                      
 *                                                                       ************      ************                                        
 *                                                                     ************      ************                                          
 *                                                                   ************      ************                                            
 *                                                                 ************      ************                                              
 *                                                               ************      ************                                                
 *                                                             ************      ************                                                  
 *                                                           ************      ************                                                    
 *                                                         ************      ************                                                      
 *                                                       ************      ************                                                        
 *                                                     ************      ************                                                          
 *                                                   ************      ************                                                            
 *                                                 ************      ************                                                              
 *                                               ************      ************                                                                
 *                                             ************      ************                                                                  
 *                                           ************      ************                                                                    
 *                                         ************      ************                                                                      
 *                                       ************      ************                                                                        
 *                                     ************      ************                                                                          
 *                                   ************      ************                                                                            
 *                                 ************      ************                                                                              
 *                               ************      ************                                                                                
 *                             ************      ************                                                                                  
 *                           ************      ************                                                                                    
 *                         ************      ************                                                                                      
 *       ****************************      ************                                                                                        
 *     ****************************      ************                                                                                          
 *   ****************************      ************                                                                                            
 * ****************************      ************                                                                                              
 * 
 * 
 * 
 * ============================================================================================================================================
 * 
 */
#ifndef __IP_UART_H_
#define __IP_UART_H_
#include "usart.h"
#include "IP_DMA.h"





//获取发送dma实例
#define cIP_UART_txDMA(ip_uart) ((ip_uart)->Instance.DMA_Tx->Instance.Stream)

//获取接收dma实例
#define cIP_UART_rxDMA(ip_uart) ((ip_uart)->Instance.DMA_Rx->Instance.Stream)

//获取spi实例
#define cIP_UART_UART(ip_uart)   ((ip_uart)->Instance.UART)


typedef struct _IP_UART{
  
  struct
  {
    USART_TypeDef* UART;
    IP_DMA* DMA_Tx;
    IP_DMA* DMA_Rx;
  }Instance;

  void* TransmitBuffer;
  int TransmitBufferSize;
  void* RecvBuffer;
  int RecvBufferSize;

  void* volatile CurrentRecvBuffer;
  volatile int ParityError;

  void* v;
  //发送完成回调
  void (*TransmitDoneCallback)(void*);
  //接收完成回调
  void (*RecvDoneCallback)(void*,void*,int);

  void (*SetIrqCallback)(void (*)(void*),void*);//用于设置中断回调

}IP_UART;




/**
 * @brief 初始化
 * @param ip_uart 空的IP_UART对象
 * @param DMA_Tx 空的dma对象(已分配内存的 如果不使用可为NULL)
 * @param DMA_Rx 空的dma对象(已分配内存的 如果不使用可为NULL)
 * @param _huart huart句柄
 * @param SetIrqCallback 设置UART中断的方法, 用于其内部设置中断调用
 * @return 无
 */
void IP_UART_Init(IP_UART* ip_uart,IP_DMA* DMA_Tx,IP_DMA* DMA_Rx,UART_HandleTypeDef* _huart,void (*SetIrqCallback)(void (*)(void*),void*));

/**
 * @brief 反初始化
 * @param ip_uart IP_UART对象
 * @return 无
 */
void IP_UART_DeInit(IP_UART* ip_uart);

/**
 * @brief 设置回调方法
 * @param ip_uart IP_UART对象
 * @param v 回调传入参数
 * @param TransmitDoneCallback 发送完成回调
 * @param RecvDoneCallback 接收完成回调
 * @return noEdit
 */
void IP_UART_DMATxRx_SetCallback(IP_UART* ip_uart,void* v
  ,void (*TransmitDoneCallback)(void*),void (*RecvDoneCallback)(void*,void*,int));





/**
 * @brief UART开始dma发送接收
 *        接收与发送开始工作 接收到数据会调用接收回调 通过 IP_UART_DMATxRx_Transmit()写入要发送的数据
 * @param ip_uart IP_UART对象
 * @param TransmitBuffer 发送缓冲区
 * @param TransmitBufferSize 发送缓冲区大小 单位:字节
 * @param RecvBuffer 接收缓冲区(同一时间只会有一半在使用)
 * @param RecvBufferSize 接收缓冲区大小 单位:字节 (建议为2的倍数 否则多出来的1字节将不使用)
 * @return 无
 */
void IP_UART_DMATxRx_Start(IP_UART* ip_uart,void* TransmitBuffer,int TransmitBufferSize,void* RecvBuffer,int RecvBufferSize);

/**
 * @brief 获取UART发送是否完成
 * @param ip_uart IP_UART对象
 * @return 0:完成 其他:未完成
 */
int IP_UART_DMATxRx_TransmitIsDone(IP_UART* ip_uart);

/**
 * @brief 发送数据 本方法适用于8bit模式 使用前应使用IP_UART_DMATxRx_SetCallback()来设置回调
 * @param ip_uart IP_UART对象
 * @return 0:成功 其他:错误
 */
int IP_UART_DMATxRx_Transmit(IP_UART* ip_uart,unsigned char* Buffer,int Length);

/**
 * @brief 获取一次性最大能发送数据的大小
 * @param ip_uart IP_UART对象
 * @return 数据大小
 */
int IP_UART_DMATxRx_GetMaxTransmitSize(IP_UART* ip_uart);

#endif //__IP_UART_H_
